Skip to content

fix(react): the unevaluated-expression diagnostic lists properties, the channel its sibling recommends - #7955

Merged
os-sam merged 2 commits into
mainfrom
claude/issue-7849-properties-diagnostic-consistency
Sep 6, 2026
Merged

fix(react): the unevaluated-expression diagnostic lists properties, the channel its sibling recommends#7955
os-sam merged 2 commits into
mainfrom
claude/issue-7849-properties-diagnostic-consistency

Conversation

@claude

@claude claude Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Fixes #7849

What was wrong

Two dev-build diagnostics in @object-ui/react answered the same authoring
question two ways, and one node can trip both:

  • utils/propsBagDiagnostic.ts"props is NOT hoisted onto the node — only
    properties.* is. … Write them under properties instead (or at node level,
    where the node's schema declares the key)."
  • utils/unevaluatedExpression.ts"Channels that do evaluate and read back
    today: content, or resolve the value in the host before handing the schema
    to SchemaRenderer."

An author whose node tripped both was told to use properties by the first and,
by the second, that the only channels that work are content or host-side
resolution.

Note the card pointed at packages/react/src/SchemaRenderer.tsx; the two
messages actually live in the two utils/ modules above.

Direction: measured, not inferred from the COMPAT label

The card left two readings open — the enumeration is incomplete, or properties
is a shim on the way out and the recommendation is the bug. Deciding that from
the word COMPAT on the hoist would be an inference, so it was measured
instead. No retirement is on record for properties:

Surface searched Terms Result
docs/adr/** properties, deprecat, retire, sunset No ADR retires the properties bag. Hits are unrelated retirements (FAB, sys_*, requiredWhen).
@objectstack/spec@17.2.0 retiredKey() tombstones retiredKey × props/properties Mechanism is live in spec, and neither bag is tombstoned.
@objectstack/spec src/ui/component.zod.ts properties "The vocabulary here is ALIVE — this is not dead surface to retire under ADR-0049." and "PageComponentSchema.properties is still z.record(z.string(), z.unknown())" — the carrier is unchanged on purpose, and it is gated at the authoring door by validate-component-props.ts.
Repo source @deprecated markers @deprecated × properties None on properties.
Repo source "legacy" annotations legacy × props/properties The opposite: "The legacy props bag, minus every key the canonical properties bag also …" and "(props is an annotated legacy alias)" (SchemaRenderer.tsx).
.changeset/*.md (960 files), all CHANGELOG.md deprecat, retire, sunset, hoist Retirement machinery is heavily exercised in this repo, and none of it names properties.
GitHub issues retire/deprecate the properties bag or the hoist No retirement card. Control query returned #7849/#6760/#6752, so the empty result is a reading, not a dead channel. #6760 hardened the hoist with a guard rather than retiring it.

⇒ the enumeration was the wrong half. This PR adds properties to it, and
changes nothing else.

Reproduction of the card's three readings

Re-run on this branch's base through the real renderers (packages/components/src/renderers/**)
driven by SchemaRenderer, rendered DOM:

badge, properties: { label: "${data.status}", variant: "${…}" }
  -> class "… border-transparent bg-secondary text-secondary-foreground …"
     and TEXT CONTENT "completed"                                    WORKS

card, properties: { className: "${data.isPriority ? 'border-red-500' : …}" }
  -> class "rounded-lg border bg-card text-card-foreground shadow-sm
     border-red-500"                                                 WORKS

badge, props: { … same keys … }
  -> "completed" lands only on a DOM ATTRIBUTE; TEXT CONTENT EMPTY   NOT READ BACK
card,  props: { … same keys … }
  -> class "rounded-lg border bg-card text-card-foreground shadow-sm"
     — border-red-500 ABSENT                                         NOT READ BACK

All three reproduce the card exactly, so both readings stood and the retirement
measurement is what picked the direction.

The fix

formatUnevaluatedExpressionMessage now reads:

Channels that do evaluate and read back today: content; properties.*,
which is evaluated and then HOISTED onto the node, so a renderer declared as
({ schema }) reads it back at the node top level; or resolve the value in the
host before handing the schema to SchemaRenderer.

The wording is borrowed from the sibling diagnostic on purpose ("hoisted onto
the node", "a renderer declared as ({ schema })") — one hoist, one vocabulary,
no invented terms.

The pin, and its positive control

packages/react/src/__tests__/diagnosticChannelConsistency.test.ts is a
derived assertion, not two hard-coded strings: the channel is parsed back
out of the message propsBagDiagnostic actually emits, the enumeration is
parsed out of the other, and the test asserts the first appears in the second.
Reword either message and the pin still asks the question that matters. Both
regexes are asserted to have matched before they are compared, so a silent miss
cannot pass as green.

Positive control — contradiction reinstated (properties.* dropped from the
enumeration), mutation confirmed on disk before the run
(removed_text_count=0, injected_text_count=1, blob 4a476fe1fa52deb7):

× the channel the props diagnostic RECOMMENDS is listed by the unevaluated diagnostic as one that works
  Test Files  1 failed (1)   Tests  1 failed | 4 passed (5)

AssertionError: objectui#7849: `propsBagDiagnostic` tells the author to write the key
under `properties`, but `unevaluatedExpression`'s list of channels that evaluate and
read back does not mention it. …

Exactly one test red, and it names itself. Restore proven by state, not by
exit code: git diff HEAD empty and the blob back to HEAD's
4a476fe1efb027d8cdb5e456ee78cc5139e3e865. The script carried an absolute-path
trap … EXIT INT TERM.

Verification — all at final commit 888ebec86, clean tree

Gate Exit Evidence
@object-ui/react pnpm test 0 RUN v4.1.10 /home/user/objectui-issue-7849 · Test Files 73 passed · Tests 876 passed
@object-ui/react pnpm run type-check 0 tsc --noEmit && tsc -p tsconfig.test.json, 0 TS#### lines
type-check non-vacuity --listFiles: both changed files present in a program (source in both, pin file in the test program)
eslint . over packages/react 0 138 files (count from --format json), 0 errors; my two files 0/0 (the 347 warnings are pre-existing elsewhere in the package)
check-changeset-presence.mjs 0 "2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s)"
check-changeset-fixed.mjs 0 ✅ All workspace packages in the fixed group
check-changeset-no-major.mjs 0 ✅ No changeset declares a major bump
check-changeset-overwrite.mjs 0 ✅ No pre-existing changeset modified or deleted
check-control-bytes.mjs 0 ✅ scanned 6414 tracked text files

Changeset grade was not reasoned aboutcheck-changeset-presence.mjs was
run and its verdict followed: it demanded one and scored "minor at most, never
major"
; a dev diagnostic an author reads does change in a published package, so
patch.

Scope

  • Clause-②: no
  • Diagnostic text only. No evaluation, hoist or schema behaviour changed;
    the properties runtime is untouched.
  • No content/docs/ page touched (the card's zero-properties-examples
    constraint holds), no packages/types/, no governance surface.
  • File surface: the diagnostic source + one pin test (+ the changeset the
    checker demanded).

🤖 Generated with Claude Code


Generated by Claude Code

os-sam and others added 2 commits September 6, 2026 04:24
… the channel its sibling recommends

Two dev diagnostics in `@object-ui/react` answered the same authoring question
two ways, and one node can trip both. `propsBagDiagnostic` tells the author
"`props` is NOT hoisted onto the node — only `properties.*` is … Write them
under `properties` instead"; `unevaluatedExpression` enumerated "channels that
do evaluate and read back today" as `content` or host-side resolution only,
omitting `properties`.

The enumeration was the wrong half, measured rather than inferred from the
`COMPAT` label on the hoist. No retirement is on record for `properties`:
`@objectstack/spec@17.2.0` calls the vocabulary carried there "ALIVE — this is
not dead surface to retire under ADR-0049", keeps `PageComponentSchema.properties`
as the open carrier on purpose, gates it at the authoring door, and tombstones
no part of it via `retiredKey()`. In this repo `props`, not `properties`, is the
spelling annotated as the legacy alias.

Reproduced through the real renderers on this branch's base: `badge` with
`properties.label = "${data.status}"` renders `completed` with variant classes,
`card` with a conditional `properties.className` renders `border-red-500`, and
the same keys under `props` render an empty badge body and no `border-red-500`.

Diagnostic text only — no evaluation, hoist or schema behaviour changes.
Pinned by a derived assertion: the channel parsed out of the `props` message
must appear in the enumeration parsed out of the other, so a reword of either
cannot reintroduce the contradiction. objectui#7849

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KbJQ1y1J12nZxYzFWhP8Q3
objectui#7849

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KbJQ1y1J12nZxYzFWhP8Q3
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 50 chunks) 3189.6 KB 3191.4 KB
Main entry chunk (gzip) 143.5 KB 350 KB
Entry file index-BwQ9i7YN.js
Status PASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 15.67KB 5.75KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 510.60KB 116.20KB
core (index.js) 6.96KB 2.79KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 182.08KB 50.62KB
fields (index.js) 242.44KB 61.25KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 4.28KB 1.75KB
i18n (index.js) 3.65KB 1.47KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.98KB 10.98KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 4.39KB 1.66KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 11.71KB 4.29KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 47.87KB 13.31KB
plugin-charts (index.js) 70.92KB 19.75KB
plugin-chatbot (index.js) 196.19KB 46.37KB
plugin-dashboard (index.js) 132.88KB 34.69KB
plugin-designer (index.js) 212.86KB 43.19KB
plugin-detail (index.js) 250.55KB 64.06KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 132.87KB 32.66KB
plugin-gantt (index.js) 167.26KB 41.00KB
plugin-grid (index.js) 209.29KB 56.78KB
plugin-kanban (index.js) 52.71KB 14.55KB
plugin-list (index.js) 113.56KB 27.70KB
plugin-map (index.js) 20.44KB 6.78KB
plugin-markdown (index.js) 13.93KB 4.81KB
plugin-report (index.js) 43.59KB 11.97KB
plugin-timeline (index.js) 30.40KB 8.76KB
plugin-tree (index.js) 9.20KB 3.19KB
plugin-view (index.js) 85.24KB 20.94KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 81.07KB 26.86KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.63KB 2.18KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 5.41KB 2.34KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 4.93KB 2.24KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 10.35KB 3.60KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 1.00KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.25KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 4.73KB 2.28KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@os-sam
os-sam marked this pull request as ready for review September 6, 2026 04:47
@os-sam
os-sam added this pull request to the merge queue Sep 6, 2026
Merged via the queue into main with commit d1bebb0 Sep 6, 2026
34 checks passed
@os-sam
os-sam deleted the claude/issue-7849-properties-diagnostic-consistency branch September 6, 2026 05:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

1 participant